home *** CD-ROM | disk | FTP | other *** search
/ Die Speccy' 97 / Die Speccy' 97.iso / amiga_system / the_aminet / comm / bbs / cddc_12.lha / cddc.doc < prev   
Text File  |  1995-10-19  |  4KB  |  112 lines
  1. Short: StdIO-Door for CD-Roms - easy to use
  2. Author: marc_albrecht@act.ohz.north.de
  3. Type: comm/bbs
  4. Version: 1.21
  5. Long:
  6.  
  7. Usage: start cddc with this template:
  8.  
  9.         cddc Device/A Dir/K
  10.  
  11. You have to give a DEVICE - e.g. "CD0:" - from which Cddc shall read. There
  12. is not much more to be said about this one.
  13.  
  14. If you have a readymade directory file you can very much speed up Cddc. A
  15. directory file contains all pathes to directories the user may have access
  16. to. This way you can also exclude certain pathes from the user's access
  17. since Cddc only respects those directories given in a directory file. If
  18. you do not supply such a file, ALL directories on the "Device" can be
  19. accessed!
  20.  
  21. There is a further advantage in using directory-files: if the path to the
  22. directory is followed by an asterik ("*") and a filename, Cddc will use
  23. this file IN the preceeding directory when displaying the filelist from
  24. which the user can choose the files to download.
  25.  
  26. Example:
  27.  
  28. .........cut............
  29. cd0:aminet/comm/bbs *files.bbs
  30. cd0:aminet/comm/misc *files.bbs
  31. cd0:aminet/comm/fido
  32. .........cut............
  33.  
  34. This would allow the user to access the directories "comm/bbs", "comm/misc"
  35. and "comm/fido" on an aminet-cd, where "bbs" and "misc" have their
  36. "files.bbs" which include descriptions to the files in the directory. In
  37. "fido" all descriptions will display "-no description-" since no
  38. "files.bbs" is specified.
  39.  
  40. NOTE: You have to make sure the supplied files.bbs (or whatever) has no
  41. "header" or "footer" - just lines starting with the filename, followed by
  42. at least ONE SPACE and whatever is wanted else (filelengthes, descriptions
  43. or what else). Aminet-"files.bbs" are fine.
  44.  
  45. NOTE: Directory-files have to include the device and the full pathes to the
  46. directories - adressing must be absolute, not relative!
  47.  
  48. New in V1.2
  49. -----------
  50. If your BBS-Files Comment is again followed by a '#' you can specify which
  51. part of the files.bbs-File shall be printed out on the screen. How?
  52. As an example we set:
  53.  
  54. .........cut...........
  55. cd0:aminet/comm/bbs *files.bbs#0-16,25-0
  56. .........cut...........
  57.  
  58. This would take the first 17 (!) characters of each line as the file's
  59. name, and starting from column 25 the comment till line's end.
  60. That means: you always have to give PAIRS of numbers, each pair parted by
  61. a minus ('-'), pairs seperated by a comma (','). The first number of each
  62. pair tells CDDC the start-column of the block, the second number of each
  63. pair tells CDDC the end-column of the block. If the end number is 0, the
  64. rest of the line will be used.
  65.  
  66. So a normal set up would be, given a files.bbs like this:
  67. .........cut...........
  68. foo.lha     1.2M  12-10-94 This is something totaly useless
  69. .........cut...........
  70.  
  71. something like this:
  72. .........cut...........
  73. zd0:files/foodir *files.bbs#0-12,28-0
  74. .........cut...........
  75.  
  76. This would take the file's name (you NEED this as first part), leave out
  77. the file's size (since this is calculated by CDDC anyway) and the date
  78. and print out the explanation ("This is something....").
  79. This way you SHOULD be able to use files.bbs from other formats as well as
  80. "normal" Aminet-ones.
  81.  
  82. Results:
  83. --------
  84. Cddc can be ended by sending a CTRL_C to it or by the user via it's menus.
  85. A file "ram:cddc.batch" has been generated - if the user marked files. You
  86. can even pass a "ram:cddc.batch" to cddc - simply have it ready when
  87. starting cddc. The files included (full pathes!) will then be included in
  88. the batch and can also be deleted by the batch-editor.
  89.  
  90. Bugs:
  91. -----
  92. I have tested Cddc and found no SERIOUS bug. If you do encounter one,
  93. please let me know.
  94.  
  95. Author:
  96. -------
  97. I can be reached via "root@act.ohz.north.de" or FidoNet 2:241/205 -
  98. FidoNet adresses tend to change! Have a look into the actual NodeList or
  99. use E-Mail.
  100. Please note that my name has changed (former Marc Fuehrer) due to my
  101. marriage.
  102.  
  103. P.S.
  104. ----
  105. I will continue working on Cddc since there are still options to include. I
  106. am planning to restrict access to certain directories via user-levels,
  107. maybe even with passwords (I HATE passwords :-) )
  108.  
  109. I would be happy to receive mail, suggestions, gifts - but besides of this
  110. (are there people WILLING to use this software?) Cddc is FREEWARE and may
  111. be copied, used, resold without making ANY profit of it.
  112.